Skip to content

Replace prose reference files with structured Platform API#14

Merged
discreteds merged 43 commits intomainfrom
feature/platform-api-restructure
Apr 27, 2026
Merged

Replace prose reference files with structured Platform API#14
discreteds merged 43 commits intomainfrom
feature/platform-api-restructure

Conversation

@discreteds
Copy link
Copy Markdown
Member

Summary

  • Replaces 6 duplicated prose-based reference files (platform-mappings.md + 5 *-tools.md) with a structured pseudocode library
  • New platform-api.md defines PlatformSpec type system, canonical Operation/CanonicalEvent enums, and 11 deterministic lookup functions
  • 6 per-platform data files in platforms/ each declare a complete PlatformSpec dictionary
  • Relocates Codex subagent dispatch prose to lib/patterns/subagent-dispatch.md
  • Updates all consumers: GEMINI.md, AGENTS.md, CLAUDE.md, 6 rubric YAMLs, CI workflow, 3 pattern files, CONTRIBUTING.md, rubric-framework.md
  • Removes unverified Codex community directory claims (Codex review finding)

Test plan

  • CI passes (platform spec existence checks updated)
  • grep -rn 'platform-mappings\|gemini-tools\.md\|codex-tools\.md' lib/ skills/ GEMINI.md AGENTS.md CLAUDE.md .github/ CONTRIBUTING.md returns no stale references
  • All 6 platform specs present in lib/references/platforms/
  • No LOOKUP comments remain in rubric YAMLs

🤖 Generated with Claude Code

discreteds and others added 30 commits April 27, 2026 14:51
Defines a structured pseudocode library to replace the duplicated
prose-based reference system (platform-mappings.md + 5 *-tools.md files)
with typed PlatformSpec dictionaries, canonical operation enums, and
deterministic lookup functions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
ClawHub URL was clawhub.dev (wrong), corrected to clawhub.ai.
Auth/publish commands updated from fabricated `openclaw auth login` /
`openclaw plugins publish` to actual ClawHub CLI (`clawhub login`,
`clawhub package publish`). Install syntax corrected to
`openclaw plugins install clawhub:<pkg>`.

Found by Codex adversarial review of the platform API restructure spec.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
14 tasks covering: platform-api.md creation, 6 PlatformSpec files,
subagent-dispatch.md prose relocation, consumer updates (GEMINI.md,
AGENTS.md, CLAUDE.md, 6 rubric YAMLs, CI, patterns, CONTRIBUTING),
and old file deletion.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
claude-code, gemini-cli, codex, cursor, antigravity, openclaw
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace LOOKUP["..."]["platform"] patterns with REGISTRY[platform].* property
paths and strip_fields()/tool_name()/supported_tools() function calls throughout
all 6 platform rubric YAMLs and rubric-framework.md. Also update *-tools.md
file references to lib/references/platforms/*.md paths.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Removes platform-mappings.md and 5 *-tools.md files, replaced by
platform-api.md + 6 structured PlatformSpec files in platforms/.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Updates UPSTREAM.md re-seeding instructions and SKILL.md external
references to point to the new platform API structure.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
SkillsMP.com and Smithery.ai are not verified in the researched Codex
platform docs. Only $skill-installer and direct GitHub URL install
paths are documented.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Defines how to align rubric check pseudocode with the Platform API:
fix tool_name() calls, inline opaque functions, unify synonyms,
and document the pseudocode/prose decision boundary.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- remaps_claude_tools inline now resolves canonical ops to native names
  via tool_name() before checking for remapping (Codex review finding)
- Reconciliation matrix: replace false "zero gaps" claim with open
  items 35-39 for rubric check alignment work

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
10 tasks: create principles doc, add framework cross-ref, fix 4
tool_name() calls, inline 7 opaque functions, unify 4 retired
synonyms, update reconciliation matrix.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- codex: Task→subagent.dispatch, TodoWrite→task.track
- gemini-cli: Task→subagent.dispatch
- openclaw: Task→subagent.dispatch (2 instances)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
find_file→find_first, count→len in codex, cursor, gemini-cli, openclaw

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…trix

All verification checks pass: zero stale tool_name() args, zero opaque
functions, zero retired synonyms, pseudocode-principles doc created.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
directory_exists→dir_exists in manifest-generation.md
count→len in injection-checks.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
9 hardcoded platform data instances across 5 pattern files to replace
with REGISTRY lookups. 2 new reverse-lookup helpers for platform-api.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Include extra_events in Codex hook allowlist derivation
- Add marketplace_path to PlatformSpec.manifest instead of supplementary list
- Derive context_checks from both primary_file and secondary_files
- Add GEMINI.md to Antigravity secondary_files as prerequisite

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
9 tasks: PlatformSpec prerequisites, 2 new API functions, 5 pattern
file edits, verification + reconciliation matrix update.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- marketplace_path field in manifest type
- platform_for_spec() and platform_for_hooks() for inventory lookups

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…secondary_files

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…okups

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
discreteds and others added 13 commits April 27, 2026 23:36
…tion-checks

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Uplift Target Registry (3 entries) and Template Registry (10 entries)
in lib/references/ with concept-aligned directories.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add missing Antigravity and OpenClaw template entries (10→12)
- Add template_for_path() lookup matching rubric template contract
- Add completeness verification checks

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
8 tasks: 2 registry files, 3 SKILL.md consumer edits, inventory
sidecar strategy, manifest-generation table, reconciliation matrix.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- uplift-targets/registry.md: 3 entries, 2 lookup functions
- templates/registry.md: 12 entries, 3 lookup functions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Phase 0b: derive options from UPLIFT_TARGETS
- Phase 5: ALLOWED_CATEGORIES → allowed_categories()
- Phase 5: resolve_target_path → template_for_path().target_path
- External references: add registry paths

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…on matrix

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Per-schema sections now document only rendering notes (conditional logic,
field requirements). Target paths and template locations are looked up
via template_for_schema() from the Template Registry.

Added antigravity-package and openclaw-plugin sections for completeness.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Each per-schema section is now a GENERATE() function that:
- Looks up paths via template_for_schema() from the Template Registry
- Dispatches to the correct rendering mode (plain/conditional/builder)
- Documents schema-specific logic as inline comments

All rendering notes preserved: conditional key omission, Gemini optional
fields, variable substitution, codex native-plugin-packaging gates, etc.
Added antigravity-package and openclaw-plugin sections.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@discreteds discreteds merged commit 7550b9c into main Apr 27, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant